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ABSTRACT 


TRADES  simulates  cargo  shipment  between  ports  for  two 
modes  of  operation,  commercial  and  military  over-the-beach 
cargo  movement. 

This  event-storing  simulation,  written  in  FORTRAN  IV, 
accepts  (as  Input  data)  ports,  itineraries,  cargo  types  and 
quantities,  numbers  of  ship  types,  cargo  transfer  rates,  and 
unit  costs.  The  execution  routines  compute  the  time-distance- 
tonnage  relationships  for  stated  input  data  to  establish  cargo 
loaded,  transloaded,  and  off-loaded  at  each  port;  queue 
characteristics;  utilization  of  ships;  and  system  operating 
costs.  The  output  can  provide  entire  histographlc  summaries 
at  specified  simulation  Intervals  In  desired  formats  for 
Information  at  port  for  the  entire  system. 

This  report  describes  the  model's  logic  elements  and  all 
the  Inputs  needed  by  the  TRADES  model. 


ADMINISTRATIVE  INFORMATION 


The  TRADES  model  was  developed  for  use  In  the  Merchant  Shipping  and  Transfer 
Craft  Requirements  in  Support  of  Amphibious  Operations  project,  initiated  by  the 
Research  and  Technology  Division  of  the  Naval  Supply  Systems  Command  (NAVSUP  043). 
Technical  guidance  was  provided  by  the  Planning  and  Studies  Division,  Development 
Center,  Marine  Corps  Development  and  Evaluation  Command.  The  David  W.  Taylor 
Naval  Ship  Research  and  Development  Center  (DTNSRDC)  undertook  the  project  in 
FY  77.  The  Logistics  Division  (Code  187)  of  the  Computation,  Mathematics  and 
Logistics  Department  was  the  performing  organization. 
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INTRODUCTION 


Current  Department  of  Defense  contingency  military  planning  includes  plans 
for  amphibious  operations  involving  the  establishment  of  beachheads  in  overseas 
arenas*  Once  such  a  beachhead  is  established,  U.S.  Forces  operating  from  the 
beachhead  area,  or  Amphibious  Operations  Area  (AOA) ,  require  continuing  logisti¬ 
cal  support*  Such  support  wm-id  be  provided  by  the  Military  Sealift  Command 
(MSC) ,  utilizing  ships  directly  under  its  command  and  merchant  ships  it  has 
under  contract  which  may  be  called  into  service  when  required  under  military 
contingencies  as  contractually  specified* 

The  specific  operational  characteristics  of  the  MSC  fleet  need  to  be  defined 
as  accurately  as  possible  before  its  actual  deployment*  A  digital  computer  simu¬ 
lation,  TRADES,  has  been  written  for  this  purpose*  Although  TRADES  can  simulate 
all  phases  of  cargo  handling,  including  cargo  generations,  ship  loading,  overseas 
transport,  ship  unloading,  ship-to-shore  cargo  transportation,  and  offloading  of 
cargo  at  the  beachhead,  the  emphasis  is  on  the  ship-to-shore  phase  of  the 
operation* 


BACKGROUND 

At  its  start  the  project  on  Merchant  Shipping  and  Transfer  Craft  Require¬ 
ments  for  Support  of  Amphibious  Operations  used  the  Requirements  Evaluated  Against 
Cargo  Transportation  (REACT)  model  developed  by  Research  Associates  Incorporated 
for  the  Integrated  Sealift  Study*  REACT  simulates  the  movement  of  ships  trans¬ 
porting  cargo  among  a  group  of  ports,  and  its  use  assumes  that  port  facilities 
are  available*  However,  it  is  possible  that  port  facilities  would  be  unavailable, 
necessitating  the  delivery  of  cargo  over-the-beach*  The  ships  would  then  have  to 
be  unloaded  offshore  and  the  cargo  delivered  ashore  by  transfer  craft*  The 
TRADES  Model,  developed  for  use  in  the  Merchant  Ship  Project*  to  determine 
merchant  ship  and  transfer  craft  force  levels  for  various  scenarios,  was  used  to 
evaluate  ship  and  transfer  craft  requirements  by  simulating  their  operations* 


*Gray,  M*,  "Mechant  Shipping  and  Transfer  Craft  Requirements  in  Support  of 
Amphibious  Operations,"  DTNSRDC  Report  77-0039  (Apr  1977)* 


2 


MODEL  DESCRIPTION 


SHIPS 

This  simulation  accepts  as  Input  ports,  number  of  ships  and  their  types, 
cargo  types  and  quantities,  cargo  transfer  rates,  and  unit  costs.  The  output  can 
provide  entire  histographlc  summaries  depicting  shipping  activities  and  cargo 
movement  at  specified  simulation  Intervals  In  desired  formats. 

The  basic  role  of  a  ship  In  the  simulation  is  to  carry  cargo  from  ports  of 
origin  to  destinations.  Each  ship  in  the  simulation  has  two  characteristics,  its 
type  (physical  description),  and  its  mode  of  operation  (transport  pattern).  Ship 
types  and  transport  patterns  (i.e.  Itinerary  or  non-itinerary  port  schedules) 
determine  ship  utilization  and  cargo  delivery. 

Ship  Types 

A  ship's  type  is  defined  by  its  physical  characteristics,  cargo  preferences, 
and  berthing  requirements.  The  following  characteristics  determine  a  ship  type: 
o  Speed 

o  Shipping  capacity  -  weight  and  volume 
o  Draft 

o  Transfer  systems 
o  Berthing  facility  preference 

The  ship  types  considered  by  TRADES  are  roll-on/ roll-off  (RORO)  ships, 
barges  or  lighter  carriers  (LASH  ships),  tanker  ships,  break  bulk  (BB)  ships, 
and  container  ships. 

Itinerary  Ships 

An  itinerary  ship  is  one  assigned  to  a  predetermined  (set  by  input)  port 
schedule,  called  an  itinerary,  which  is  an  ordered  list  of  ports.  Itinerary 
ships  service  all  ports  on  their  itinerary  in  the  order  in  which  the  ports 
appear.  Because  cargo  does  not  control  the  operation  of  itinerary  ships,  it  is 
possible  for  a  ship  to  enter  and  leave  a  port  on  its  itinerary  without  transfer¬ 
ring  any  cargo. 
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EXAMPLE:  A  ship  has  an  itinerary  of  ports  A,  B,  C,  and  D.  The  ship  starts  its 
service  cycle  at  port  A  and  services  port  B,  C,  and  D  in  that  order.  When  the  ship 
has  completed  service  at  the  last  port  on  the  itinerary,  port  D,  it  returns  to 
port  A,  and  continues  its  service  cycle. 


Non-Itinerary  Ships 

A  non-itinerary  ship  is  one  whose  operation  in  the  simulation  is  determined 
by  the  quantity  of  cargo  to  be  moved  and  the  space  required  to  move  that  cargo. 
Non-itinerary  ships  enter  a  ship  pool  at  their  respective  availability  times. 
These  ships  leave  the  pool  only  when  they  are  needed  to  move  cargo  and  return  to 
the  pool  when  they  are  not  needed.  The  ship  pool  is  discussed  later.  The 
schedule  of  a  non-itinerary  ship  is  determined  by  the  destination  ports  of  the 
cargo  the  ship  can  carry. 


EXAMPLE:  A  ship  is  servicing  port  A  and  is  equipped  to  handle  the  following 
waiting  cargo: 

CARGO  COMMODITY  TYPE  DESTINATION  PORT 

1  B 

2  C 

3  D 

4  E 


The  following  table  shows  the  distances  in  nautical  miles  between  ports 
A,  B,  C,  D,  and  E.  The  quantities  of  cargo  waiting  at  a  port  determine  the 
schedule  of  a  non-itinerary  ship. 

DISTANCE  TABLE 


A 

B 

C 

D 

E 

A 

- 

100 

10 

50 

150 

B 

100 

- 

50 

75 

100 

C 

10 

50 

- 

100 

110 

D 

50 

75 

100 

- 

105 

E 

150 

100 

110 

105 

- 
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The  ship  will  travel  to  the  nearest  port  for  which  it  has  cargo.  The  port  schedule 
of  this  non-itinerary  ship  is  thus  A  to  C  (distance  10),  C  to  B  (50),  B  to  D  (75), 

D  to  E  (105).  If  there  is  cargo  waiting  for  shipment  at  ports  B  through  E,  TRADES 
will  adjust  the  schedule  accordingly. 

Theater  Operations 

A  theater  is  a  group  of  ports  to  be  considered  as  a  unit.  An  Intratheater 
ahip  loads  cargo  only  for  those  ports  which  are  in  the  same  theater  as  the  port 
generating  the  cargo.  The  ship  then  sails  for  the  nearest  port  for  which  it  has 
cargo.  If  it  has  no  cargo  aboard  and  there  is  any  intratheater  cargo  at  any  other 
port  in  the  same  theater,  the  ship  will  sail  to  the  nearest  port  with  the  largest 
amount  of  waiting  cargo.  If  no  port  has  Intratheater  cargo  awaiting  shipment,  the 
ship  joins  the  ship  pool  at  its  home  port. 

Ships  assigned  to  intertheater  operation  load  cargo  generated  in  one  theater 
for  delivery  to  another  theater.  If  its  home  and  delivery  theaters  are  the  same, 
an  Intertheater  ship  can  operate  as  an  intratheater  ship.  Intertheater  ships  have 
the  following  operation  options  which  are  set  by  input: 

o  Load  cargo  in  home  theater  for  delivery  in  another 
theater  and  return  to  home  theater  for  delivery  in 
home  theater 

o  Load  cargo  in  home  theater  for  delivery  in  home  theater 
o  Load  cargo  in  present  theater  for  delivery  in  home  theater. 

Both  Intratheater  and  intertheater  ships  search  for  cargo  to  be  loaded 
according  to  the  following  criteria; 

o  Is  the  cargo  acceptable  for  this  ship? 
o  Is  the  depth  of  the  destination  port  compatible  with 
the  ship  draft? 

o  Does  the  destination  port  have  acceptable  berthing 
and  transfer  facilities? 

Both  Intratheater  and  Intertheater  ships  must  maintain  a  minimum  utilization 
of  volume  and  weight.  If  the  current  percentage  of  utilized  volume  and  weight 
Is  less  than  a  minimum  percentage  set  by  input  and  no  other  acceptable  cargo  will 
be  available  at  that  port  for  delivery  within  a  specified  time,  the  ship  searches 
the  other  ports  in  l'.;s  home/present  theater  for  cargo  destined  for  the  delivery 
theater.  If  it  finds  an  amount  of  acceptable  cargo  greater  than  or  equal  tc  an 
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amount  specified  by  input,  the  ship  sails  for  that  port  to  load  that  cargo. 

If  no  such  port  is  found,  a  check  is  made  to  determine  whether  the  ship  has  cargo 
aboard.  If  there  is  no  cargo  aboard,  the  ship  retires  from  operations  and  joins 
the  ship  pool  at  a  port  determined  by  input.  If  the  ship  has  any  cargo  at  all,  it 
sails  to  the  ports  for  which  it  has  cargo.  The  closest  port  for  which  the  ship 
has  cargo  is  selected  as  the  next  port  of  call. 

Ship  Pool 

Ships  enter  the  pool  for  one  of  the  following  reasons: 

o  Ships  are  initially  placed  in  the  pool  at  their  availa¬ 
bility  times. 

o  Ships  which  have  been  previously  in  normal  operation 
enter  the  pool  because  no  acceptable  cargo  is  available 
for  delivery. 

o  Enough  ships  are  already  in  service  to  transport  the  backlogged 
cargo.  Ships  entering  the  pool  for  this  reason  must  remain  in 
the  pool  for  a  period  of  time  set  by  input. 

When  a  ship  is  selected  from  the  pool  to  resume  operations,  it  is  made 
available  at  its  present  port.  If  the  first  demand  port  is  not  the  present  port, 
the  ship  is  available  at  the  current  time  plus  the  travel  time  to  the  first 
service  port- 

PORTS 

A  port  is  simulated  by  this  model  in  terms  of  berths  and  transfer  systems. 
Both  import  and  export  ships  at  the  port  utilize  these  systems  in  their  cargo 
movement.  Each  berth  in  the  simulation  is  described  by  its  type.  The  berth  or 
facility  type  is  defined  by  the  general  type(s)  of  ships,  such  as  general 
freighter,  non-sustaining  container  ship,  etc.,  that  can  be  accommodated  at  the 
berth.  Additional  descriptors  for  each  type  of  facility  define  the  transfer 
systems  available  at  the  facility  to  perform  cargo  operations  required  by  the 
ship.  The  cargo  handling  rates  reflect  physical  characteristics  of  the  berths 
and  material  handling  equipment. 


Berth  and  Queue  Operations 

When  a  ship  reaches  a  port.  It  must  determine  which  type  of  facility  to 
enter.  Since  preferred  facility  types  are  Input,  a  check  determines  whether  a 
first  or  second  preference  Is  available  for  the  ship.  If  the  first  preference  is 
available,  the  ship  enters.  If  the  first  preference  Is  occupied  and  a  second 
preference  Is  given  and  Is  available,  the  ship  enters  the  second  preference 
facility.  If  the  first  and  second  preferences  are  not  available,  the  ship  joins 
the  queue  (waiting  line)  to  await  service. 

When  a  ship  is  In  a  queue,  it  is  waiting  for  a  specific  type  of  facility  in  a 
particular  port.  If  more  than  one  ship  in  the  queue  Is  waiting  for  the  same  type 
of  port  facility,  the  ships  are  removed  in  the  order  in  which  they  entered  the 
queue.  As  facilities  become  available,  each  ship  in  the  queue  leaves  the  queue 
and  enters  the  first  available  facility  which  can  accommodate  It.  Each  time  a 
ship  leaves  a  port,  a  check  determines  whether  any  other  ship  In  the  queue  is 
waiting  for  the  facility  type  just  vacated.  If  such  a  ship  is  found,  it  leaves 
the  queue  and  moves  into  the  facility  and  Its  cargo  transfer  operations  begin. 

The  ship  queue  is  updated  each  time  a  ship  enters  or  leaves  a  port.' 

Over-the-Beach  Operations 

When  a  ship  arrives  in  the  AOA,  its  unloading  is  simulated.  The  time  taken 
to  unload  the  cargo  Is  computed.  The  numbers  of  transfer  craft  and  unloading 
facilities  needed  are  added  to  the  total  numbers  currently  in  use  and  sub¬ 
tracted  from  the  total  numbers  still  available  for  use  by  newly  arriving  ships. 

If  the  required  craft  and  facilities  are  not  available,  the  ship  is  put  into  a 
queue  until  such  time  as  it  can  be  accommodated. 

As  the  ship  is  unloaded,  its  cargo  is  added  to  the  total  amount  of  cargo 
previously  unloaded,  by  type,  and  the  total  amount  of  cargo  of  all  types  is  also 
calculated.  Loading  and  unloading  operations  for  each  ship  type  considered  by 
TRADES  are  described  in  the  following  paragraphs. 

Roll-on/Roll-off  Ships. 

Roll-on/Roll-off  (Ro/Ro)  ships  carry  wheeled  vehicles.  Only  causeway  ferries 
are  required  for  unloading  Ro/Ro  ships.  When  the  Ro/Ro  ship  arrives  in  the  AOA, 
it  begins  unloading  as  soon  as  the  causeway  ferries  are  available.  If  causeway 
ferries  are  not  immediately  available,  the  Ro/Ro  ship  waits  in  a  queue  until  they 


are.  Wheeled  cargo  rolls  off  the  ship  onto  the  causeway  ferries,  is  transported 

to  shore,  and  there  rolls  off  the  causeway  ferries. 

Barge  or  Lighter  Carriers.  Barge  or  lighter  carriers  (LASH  ships)  carry  their 
cargo  prepacked  aboard  barges  which  the  ship  discharges  into  the  water  using  its 
own  unloading  equipment.  After  the  barges  have  been  lowered  into  the  water,  the 
ship  is  considered  to  be  unloaded  and  the  cargo  delivered.  Since  the  LASH  ship 
unloads  independently  of  any  external  facilities,  it  begins  unloading  immediately 
on  arrival  in  the  AOA  and  is  never  required  to  wait  in  a  queue  prior  to  unloading. 

Tanker  Ships.  Tanker  ships  transport  bulk  POL  (petroleum,  oil  and  lubricants) . 

In  order  to  unload,  they  must  be  attached  to  a  pipeline  leading  ashore.  The  POL 

is  then  pumped  from  the  ship  to  a  storage  area  on  shore.  If  a  pipeline  is  not 

available  upon  arrival  of  the  tanker  in  the  AOA,  the  tanker  will  be  put  into  a 
queue  until  a  pipeline  is  available. 

Break  Bulk  Ships.  If  the  ship  is  a  break  bulk  (BB)  ship,  unloading  begins  only 
if  the  required  ship-to-shore  transfer  craft  (lighters  or  causeway  ferries)  and 
the  required  shoreslde  unloading  facilities  (forklifts)  are  available.  If  the 
required  transfer  craft  and  shoreslde  unloading  facilities  are  not  available,  the 
ship  is  put  into  a  queue  until  transfer  craft  and  unloading  facilities  are 
available.  Throughout  the  simulation,  all  transfer  craft  and  facilities  are  made 
available  to  queued  ships  on  a  first-come,  first-served  basis. 

Container  ships.  When  a  container  ship  arrives  in  the  AOA,  a  check  is  made  on 
the  availability  of  support  equipment  needed  to  unload  the  ship  and  transport  its 
cargo  ashore.  An  unloading  platform,  normally  consisting  of  a  crane  mounted 
aboard  a  barge,  is  required  to  move  containers  from  the  ship  onto  a  transfer 
craft.  The  transfer  craft  may  be  either  a  lighter  or  a  causeway  ferry.  As  the 
transfer  craft  arrive  at  the  shore,  shoreslde  cranes  unload  the  containers. 
Unloading  of  the  container  ship  begins  only  when  the  unloading  platform,  shlp-to- 
shore  transfer  craft,  and  shoreslde  cranes  are  available;  otherwise,  the  con¬ 
tainer  ship  is  placed  in  a  queue  until  the  needed  equipment  becomes  available. 
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After  the  ship  is  completely  unloaded.  It  departs  for  Its  next  port,  and  the 
transfer  craft  and  unloading  facilities  which  It  used  are  deleted  from  the  lists 
of  crafts  and  facilities  currently  in  use. 

CARGO 

Cargo  Generation 

Cargo  generation  means  that  a  certain  type  and  quantity  of  cargo  is  made 
available  at  a  specific  time  and  at  a  specific  port  to  be  delivered  to  some  other 
specified  port.  Cargo  requirements  refer  to  the  quantity  of  cargo  that  must  be 
carried  from  port  of  embarkation  to  port  of  debarkation.  In  general,  the  simula¬ 
tion  moves  generated  cargo  using  the  transportation  resources  available. 

To  generate  cargo,  the  user  must  translate  cargo  items  (household  goodo, 
munition,  etc.)  into  cargo  generation  terminology  which  includes: 

o  Cargo  type  (e.g.,  ammunition,  chill  and  freeze,  general, 
vehicles,  etc.) 

o  Time  interval  and  amount  of  cargo  to  be  generated  at  each 
interval 

o  Ports  which  generate  cargo 
o  Ports  to  which  cargo  is  to  be  delivered 
Cargo  is  generated  for  delivery  by  an  input  time-phased  schedule.  The  input 
factors  which  control  the  schedule  and  the  amount  of  cargo  for  each  generation 
include: 

o  Frequency  of  generation 
o  Time  of  initial  generation 

o  Statistical  distribution  curve  type  which  determines  the  quantity 
of  cargo  generated. 

Cargo  is  generated  at  most  once  every  simulation  day. 

Cargo  Handling  Rates 

The  rate  at  which  cargo  is  loaded  or  discharged  from  a  ship  is  a  function 
of  the  type  of  berthing  facility,  the  type  of  transfer  system  used,  and  the  type 
of  cargo  being  transferred.  This  rate  is  input  for  each  combination  allowed 
(maximum  of  six  types  of  berthing  facilities,  six  transfer  systems,  and  eight 
cargo  types) . 
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In  this  simulation,  provision  Is  made  for  adjusting  of  transfer  rates  (base 
rates)  by  other  factors  which  affect  cargo  handling.  Even  when  all  factors 
appear  to  be  the  same,  ports  may  have  different  handling  rates.  The  base  rate  Is 
modified  by  the  Input  factor  associated  with  the  port  at  which  the  ship  Is  berthed. 
The  loading  and  discharging  operations  are  assumed  to  require  the  same  amount  of 
time  for  operations  performed  using  the  same  berth  type  and  transfer  device  type. 
After  the  correct  rate  has  been  determined  for  a  given  amount  of  cargo,  the  time 
required  to  complete  cargo  handling  Is  computed  as  a  f-unctlon  of  that  rate  and 
the  amount  of  cargo  to  be  moved.  This  time  represents  only  the  time  required  to 
load/unload  the  cargo.  The  time  required  to  move  cargo  betwe^  dock  and  holding 
area  is  not  considered. 

SIMULATION  LOGIC  \ 


TRADES  Is  an  event  storing  simulation.  Such  a  model  Is  based  on  the  s^uen- 
tial  processing  of  a  list  of  procedures,  each  of  which  occurs  at  a  stated  tim^ 
Such  procedures  are  called  events.  Initial  events  are  placed  on  the  list 
(stored)  at  the  beginning  of  the  simulation,  and  they  in  turn  store  the  same  type 
of  event  or  other  events  on  the  list. 

EXAMPLE:  The  following  Initial  events  are  placed  on  the  list  for  processing: 
o  Generate  cargo  at  time  »<  1.00  day 
o  Ship  arrives  at  port  at  time  =  1.50  days 
o  Terminate  run  at  time  =  7.00  days 


A  Generate  Cargo  event  Is  stored  for  each  day  of  the  simulation;  the  times 
at  which  the  event  will  occur  are  thus  1.00,  2.00,  3.00,  etc.  Arrival  of  a  ship 
at  a  port  establishes  the  unloading  and  loading  cycles  and  the  selection  of  the 
next  port  of  call.  The  following  events  are  added  to  the  event  list: 

TIME  (Day)  EVENT  LIST 

1.50  Arrival  at  port  (.50  to  enter) 

2.00  Unloading  of  ship  (If  one  day  to  unload) 

3.00  Loading  of  ship 

5.50  Arrival  at  next  port  if  1.00  day  for  load  +  .50 
day  for  transit  to  next  port 
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Table  1  shows  a  complete  event  list  and  Figure  1,  Logic  Flowchart,  shows  the 
inter-relation  of  events  and  their  storing  sequence* 


TABLE  1  -  COMPLETE  EVENT  LIST 


TIME  (DAYS) 

EVENT 

1.00 

Cargo  generation 

1.50 

Arrival  of  ship 

2.00 

Cargo  generation 

2.00 

Unloading  cycle  for  this  ship 

3.00 

Cargo  generation 

3.00 

Loading  cycle  for  this  ship 

4.00 

Cargo  generation 

5.00 

Cargo  generation 

5.50 

Arrival  of  ship  at  next  port  of  call 

6.00 

Cargo  generation 

6.00 

Unloading  cycle  for  this  ship 

7.00 

End  game 
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INPUT 


This  section  describes  the  Input  necessary  to  run  TRADES.  Input  parameters 
are  grouped  with  respect  to  cargo,  ship,  and  port  descriptors. 

Itinerary  Card  1  (ITNl). 

ITNl  indicates  the  numbers  of  itineraries  to  be  used  in  the  simulation. 

If  ITNl  is  blank,  ITN2  cards  are  not  used. 


Variable 

Columns 

Format 

Description 

NITIN 

1-3 

13 

Number  of  itineraries  in  the 
simulation 

KK 

4-6 

13 

If  KK=1,  only  one  iteration 
is  made.  If  KK=7,  the  number 
of  iterations  is  determined 
by  SHTFLM 

Itinerary  Cards  2  (ITN2). 

1TN2  gives  the  itineraries,  l.e.,  lists  of  ports  to  be  serviced  in  order  of 
encounter.  The  maximum  number  of  Itineraries  is  10,  with  a  maximum  of  10  ports 
per  itinerary. 


Variable 

Columns 

Format 

Description 

PORT1,...,PORT10 

1-30 

1013 

Ports  to  be  serviced  in 
given  order 

Run  Identification  Card  (RDENT). 

RDENT  is  a  72-column  alphanumeric  code  describing  the  run 


General  Information  Card  (GEN). 

GEN  gives  the  values  of  variables  necessary  to  execute  the  simulation. 


Variable 

Columns 

Format 

Description 

NSHIPS 

1-9 

19 

Number  of  ships  (1  to  400) 

NSTYP 

10  -  18 

19 

Number  of  ship  types 

(1  to  30) 

NNPORT 

19  -  27 

19 

Number  of  ports  (1  to  30) 

NFACT 

28  -  36 

19 

Number  of  facility  types 

(1  to  6) 

NTEA 

37  -  45 

19 

Number  of  theaters  (1  to  6) 

lOUT 

46  -  54 

19 

Printing  option  indicator 

lOUT  0,  landing  craft 
summaries 

=  1,  landing  craft 
summaries  and 
logic  diagnostics 

>  1,  status  and  final 
summaries  only 


TINVL 

55  -  60 

F6.0 

Simulation  days  between 
status  summaries 

ENDTIM 

61  -  66 

F6.0 

Time  to  end  simulation  (days) 

Cargo  Generation  Card 

J,  (CARGl). 

CARGl  cards  give 

the  number  of 

cargo  generations  to  be  read  (1  to  1000). 

Variable 

Columns 

Format 

Description 

NCARGN 

1-10 

110 

Number  of  cargo  generations 

to  be  input  (1  to  1000) 


Cargo  Generation  Cards  2  (CARG2). 

The  CARG2  cards  describe  cargo  entering  the  simulation,  giving  cargo  type, 
origin  and  destination  ports,  and  frequency  of  generation. 


/ariable 

Columns 

Format 

Descript i on 

ENDDAY 

1  -  3 

13 

Final  day  of  generation 

STRDAY 

4-5 

13 

First  day  of  generation 

FRF.(^ 

1  -  8 

12 

Days  between  general  ions 

DLSTkl 

u 

11 

Distribution  curve  type 
indicator 

=1,  constant 

=2,  uniform 

=3,  normal 

TYPE 

10 

11 

Cargo  type 

ORIG 

11  -  12 

12 

Origin  port 

DEST 

13  -  14 

12 

Destination  port 

PARI  &  PAR2 

15  -  24 

215 

Parameters,  used  with  distri 
bution  curve,  DISTRI 

Port  Information  Cards  (PRT) . 

PRT  cards  give  the  physical  characteristics  of  each  port,  as  well  as  costing 
factors  for  ships  using  the  facility.  One  card  is  input  for  each  port. 


Variable 

Columns 

Format 

Description 

FAC(I), 

I  =  1.6 

1 

-  18 

613 

Number  of  berths  of  facility 
Type  I 

ITHR 

19 

11 

Theater 

DELAY 

20 

-  25 

F6.0 

Delay  time  (days)  in  port 

ADJPRT 

26 

-  31 

F6.0 

Port  adjustment  factor 

CSTHL 

32 

-  37 

F6.0 

Handling  cost  ($/day)  for 
each  day  ship  is  at  the  port 

DRAFT 

38 

-  43 

F6.0 

Maximum  draft  (ft),  deter¬ 
mines  largest  ship  allowed 
to  berth  at  the  port. 
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Variable 

Columns 

Format 

Description 

PRTNAM 

44  -  55 

A12 

Port  Name 

lOVBCH 

56 

11 

>=  1,  port  considered  over- 
the-beach  position  and  will 
involve  over-the-beach  opera¬ 
tions*  Otherwise,  commercial 
operations  are  assumed* 

Ship  Type  1  CARDS  (STYPl) . 

STYPl  cards  give  physical  characteristics  of  classes  of  ships*  These  cards 
also  input  cost  and  delay  factors  associated  with  the  vessel* 


Variable 

Columns 

Format 

Description 

SPEED 

1  - 

8 

F8*l 

Speed  (knots) 

CAPACW 

9  - 

15 

F8*2 

Maximum  load  (long  tons) 

CAPACV 

17  - 

24 

F8.3 

Maximum  volume  (measurement 
tons) 

CSTSEA 

25  - 

32 

F8*4 

Cost  per  day  at  sea  ($/day) 

CSTPRT 

33  - 

40 

F8.5 

Cost  per  day  in  port  ($/day) 

DRAFT 

41  - 

48 

F8*6 

Ship  draft  (ft) 

ADJTRN 

49  - 

56 

F8.7 

Multi-transfer  system  inter¬ 
ference  factor 

NTRNSl  - 
NTRNS6 

57  - 

64 

611 

Transfer  system  type  indicators 
=1,  ship  equipped  with  corre¬ 
sponding  transfer  system  type 

NTYP 

65  - 

66 

12 

Total  number  of  transfer  system 
types  aboard  ship 

CPRFl  - 
CPRF5 

67  - 

72 

611 

Cargo  type  that  ship  is  able  to 
carry  (cargo  type  input  by  user) 

FACl 

73 

11 

First  transfer  facility  type 
preference 

FAC2 

74 

11 

Second  transfer  facility  type 
preference 

20 


Columns  Format  Description 

75  II  Intertheater/ intratheacer  operations 

indicator 

“  0,  ship  can  change  both  origin  and 
delivery  theaters 

=  1,  ship  can  change  only  delivery 
theater 

=  2,  ship  can  change  neither  origin 
nor  delivery  theaters 


Ship  Type  2  Cards  (STYP2). 

STYP2  cards  are  continuations  of  the  STYPl  cards.  They  give  over-the-beach 


characteristics 

of  the  ship 

type. 

Variable 

Columns 

Format 

Description 

NLDC 

1-6 

14 

Number  of  landing  craft  required 
(BB  ship)  or  number  of  causeway 
ferries  required  (container  ship  or 
Ro/Ro) 

NTRKS 

7-12 

14 

Number  of  trucks  required  (container 
ship) 

NFKLS 

13  -  18 

14 

Number  of  forklifts  required  (BB  ship) 
or  number  of  shoreside  cranes  required 
(container  ship) 

STYP 

19  -  24 

14 

Ship  operation  type  indicator 

=  1,  Breakbulk 

2,  Container 

3,  Ro/Ro 

4,  LASH  (barge  or  lighter  carrier) 


TTRNC 

25  -  30 

14 

Type  of  transfer  craft 

YNDV 

31  -  36 

14 

Shoreside  unloading  device  indicator 

*1,  Forklift 

2,  Crane 

Variable 

KCHNG 
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Ship  Cards  (SHP). 

SHP  cards  give  ship  type  Information,  location,  and  mission  of  each 
individual  ship  to  be  considered  in  the  simulation* 


Variable 

Columns 

Format 

Description 

TAV 

1-3 

13 

Time  at  which  ship  will  be  available 
(days) 

IPRT 

4-5 

12 

Initial  port  at  which  ship  will  enter 
simulation 

ITN 

6-7 

12 

Itinerary  number,  if  ship  is  to  follow 
an  itinerary;  otherwise,  blank 

OWR 

9 

11 

Operator  of  ship 

“  1,  berth  liner 

2,  long-term  charter 

3,  friendly  foreign 

TYPE 

10  -  11 

12 

Ship  type  number 

DTH 

15 

11 

Delivery  theater 

HOME 

16  -  17 

12 

Home  port 

Card  Modification  Card 

JL  (MODI).* 

MODI  gives 

the  number 

of  ship  types 

to  be  modified* 

Variable 

Columns 

Format 

Description 

NCT 

1-3 

13 

Number  of  ship  types  to  be  modified 

If  equal  zero  or  blank,  M0D2  and  M0D4  are  omitted. 

Ship  Cards  Modification  Card  2  (M0D2). 

JK)D2  cards  give  the  ship  types  (1  to  30)  to  be  modified* 


Variable 

Columns 

Format 

Description 

NNTYPE(l)  - 
NNTYPE(30) 

1-60 

3012 

Ship  type  number  of 
ships  to  be  modified 

*'rhe  MOD  cards  allow  the  user  to  change  the  availability  times  for  a 
specified  ship  type* 
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M0D3  gives  ship  type  availability  times  to  be  tested  for  entrance  into  the 
simulation*  This  option  allows  the  modification  of  ship  availability  times  by 
ship  type*  The  ship  availability  time  (TAV)  given  on  the  ship  cards  SHP  is 
changed  by  the  parameters  given  on  the  Ship  Cards  Modification  Card  4* 

Variable  Columns  Format  Description 

NNAVAIL  1-3  13  Availability  time  (days) 

to  test  for  above  ship  types 

Ship  Cards  Modification  Card  4  (MOD4) * 

M0D4  gives  the  number  of  days  to  be  subtracted  from  the  ship's  availability 
time  if  it  is  less  than  or  equal  to  NNAVAIL  given  on  M0D3* 


Variable 

Columns 

Format 

Description 

NNNA 

1-3 

13 

Number  of  days  by  which 

availability  time  is  to  be 

decreased 

Initial  Supply  (INSUP)* 

INSUP  gives  the  amount  of  each  type  of  cargo  (days  of  supply)  initially 
carried  ashore  by  the  assault  follow-on  echelon* 


Variable 

Columns 

Format 

Description 

XIS(I) 

1-10 

F10*0 

Amount  of  type  I  cargo 
(measurement  tons) 
Initially  carried  ashore 
by  the  assault  follow-on 
echelon* 

I  =  1,  6 

CFl  gives  the  number  of  ship-to-shore  transfer  craft,  the  number  of  shoreside 
unloading  facilities  available  to  unload  the  transfer  craft,  and  an  option  for 
receiving  buildup  ashore  data  on  punched  cards  as  program  output*  See  Over-the- 
Beach  Operations,  page  7* 


Variable 

Columns 

Format 

Description 

NTCFT 

1-5 

15 

Number  of  types  of  transfer 
craft  available 

NSUFAC 

6-10 

15 

Number  of  types  of  shoreside 
unloading  facilities  available 

KPNCH 

11  -  15 

KPNCH  •=  1,  punch  output  data; 
otherwise,  no  punched  output 

Punch  Identification  Card  (PNCHID) 

• 

PNCHID  gives 

the  identifying 

information 

to  be  punched  onto  cards  containing 

the  buildup  ashore 

output  data. 

Variable 

Columns 

Format 

Description 

IDPNCH 

1-10 

AlO 

Identifying  information  to  be 
punched  onto  the  cards  contain¬ 
ing  the  buildup  ashore  output 
data. 

Card  and  Facilities  Card  2  (CF2). 

CF2  gives  the  names  of  the  transfer  craft. 

Variable  Columns  Format  Description 

MCFT(l),  1-50  5(A10)  Name  of  transfer  craft  I 


Craft  and  Facilities  Card  3  (CF3) 


CF3  gives  the  total  number  of  transfer  craft  of  each  type  that  are 
available. 


Variable 


Columns  Format 


Description 


ITCFT(I) 
I  “  1.5 


1-50  1015 


Number  of  transfer  craft  of 
type  I  that  art  available 


Craft  and  Facilities  Card  4  (CF4). 

CF4  gives  the  capacity  of  each  type  of  transfer  craft,  in  short  tons. 

Variable  Columns  Format  Description 

XTCFT  (1,1)  1-25  4F5.0  Capacity  of  transfer  craft  type  I 

i  =  1,5 


Craft  and  Facilities  Card  5  (CF5). 

CF5  gives  the  speed  of  each  type  of  transfer  craft. 


Variable 

XTCFT (I, 2) 
I  =  1,5 


Columns  Format  Description 

1  -25  5F5.0  Speed  of  transfer  craft  type  I  in 

knots 


Craft  and  Facilities  Card  6  (CF6). 

CF6  gives  the  total  number  of  each  type  of  shoreside  unloading  facilities. 


Variable 

Columns 

Format 

Description 

ISUFCd.l) 

I  =  1,5 

1-25 

515 

Total  number  of  shoreside  unload¬ 
ing  facilities  of  type  1  tliat  are 
available 

Craft  and  Facilities  Card  7  (CF7). 

CF7  gives  the  unloading  rate  for  each  type  of  shoreslde  unloading  facility* 


Variable 

Columns 

Format 

Description 

XSUFA(I) 

I  -  1,5 

1-25 

5F5.0 

Unloading  rate  for  shoreslde  unload¬ 
ing  facility  type  I  in  measurement 
tons  per  hour 

Craft  and  Facilities 

Card  8 

(CF8). 

CF8  gives  rates  for  offshore  unloading  facilities  and  delay  times  for  each 
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1 

type  of  transfer 

craft . 

1 

Variable 

Columns 

Format 

Description 

'j 

lUP(I) 

1-5 

15 

Number  of  offshore  unloading  plat¬ 
forms  available 

. ! 

XUP 

6-10 

F5.0 

Unloading  rate  for  the  offshore 
unloading  platforms  in  measurement 
tons  per  hour 

% 

TBKRTE 

11  -  20 

FIO.O 

Unloading  rate  for  a  pipeline 
unloading  a  tanker  in  measure¬ 
ment  tons  per  hour 

DTME(I) 

21  -  35 

3F5.0 

Delay  time  for  transfer  craft  type  I 
in  hours.  This  delay  time  is  added 
to  the  cycle  time  for  each  type  of 
transfer  craft. 

Ship  Pool  Status 

Card  (SPL). 

• 

SPL  gives  cargo  quantity 

criteria 

for  ship  pool  activities,  and  the  distance 

• 

from  ship  to  shore  in  over-the 

-beach  operations. 

:  i 

' 

Variable 

Columns 

Format 

Description 

DOFFSH 

1-5 

F5.0 

Distance  offshore  (nautical  miles) 
for  over-the-beach  operations 

MTSHP 

6-20 

F15.0 

Minimum  measurement  tons  of  cargo 

Waiting  at  its  service  ports  before 
a  non-itinerary  ship  can  leave  the 
pool 

MTSHLP 

21  -  35 

F15.0 

Minimum  measurement  tons  of  cargo  re¬ 
quired  for  non-itinerary  ship  to  change 
service  port 
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Iteration  Card  (ITR) . 

ITR  gives  Information  necessary  to  rerun  the  program  using  modified  input 
from  the  previous  run. 


Variable  Columns  Format 

TIMIT  1-10  FIO.O 

DECR(1)-DECR(4)  11  -  50  AFIO.O 

SHTFLM  51-60  FIO.O 


Description 

Time  (In  days)  at  which  shortialj.  l.s 
tested  (see  SHTFLM).  It  no  iterations  are 
requested,  TIMIT  is  set  greater  than  the 
simulation  end  time. 

Number  of  craft  to  be  decremented  from  the 
total  number  of  landing  craft  of  the  four 
types  for  each  Iteration 

Maximum  shortfall  (amount  of  cargo  built 
up  at  shore)  allowed  for  next  iteration. 

The  number  of  landing  craft  is  adjusted 
until  SHTFLM  is  reached.  If  SHTFLM  <  0, 
DECl  -  DEC4  are  decremented  from  the  num¬ 
bers  of  the  four  landing  craft  types  and 
the  simulation  is  iterated  until  the  number 
of  landing  craft  necessary  to  meet  the 
cargo  delivery  requirement  is  a  minimum. 
Otherwise,  the  numbers  of  landing  craft 
are  increased  until  the  cargo  requirement 
Is  met. 


Productivity  Cards  (PROD). 

PROD  cards  give  the  transfer  rates  for  each  of  the  six  berth  facility  types, 
considering  the  six  transfer  system  types  and  eight  cargo  types.  Thirty-six 
cards  are  Input. 

Variable  Columns  Format  Description 

PRODUCd , J,K)  1-48  8F6.0  Transfer  rates  (measurement 

tons  per  day)  where  I  repre¬ 
sents  facility  type,  J  repre¬ 
sents  transfer  device,  and  K 
represents  cargo  type 
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Distance  Table  Cards  (DIST) 


DIST  gives  distances  In  nautical  miles  between  ports.  A  30x30  port  table  Is 
read  using  three  cards  per  port. 


Variable 


Columns  Format 


Description 


XDlSTd.J) 
where  J=l,30 
and  1*1,30 


1-60  10F6.0 


Distance  In  nautical  miles 
between  port  I  and  port  J 


Cargo  Conversion  Factor  Card  (ADJ). 

ADJ  gives  the  values  needed  to  convert  from  measurement  tons  to  short  tons 
for  each  of  the  eight  cargo  types. 


Variable 


Columns  Format 


Description 


ADJCGO(l) 

1-48 

8F6.0 

Conversion  factor  for  each  cargo 

where  1=1,8 

type,  MT/LT 

cargo  types 

Table  2  gives  the  sequence  of  the  input  cards 
deck  A  are  read  from  file  8.  Cards  with  input  deck 


.  Cards  specified  as 
B  are  read  from  file 


input 

5. 


TABLE  2  -  SEQUENCE  OF  INPUT  DATA 


CARD 

IDENTIFICATION 


NUMBER 
OF  CARDS 


CARD  DESCRIPTION 


It  ln(?rary 

I I  iii.Tarv 

Ru['.  I  dtai C  i  t  i '■'.1 1 'Dm 

CeiH-ral  Tnf.'rmat  ioii 

Cargo  Generation 

Cargo  Generation 

Port  Information 

Ship  Type  I 

Ship  Type  II 

Ship  Information 

Ship  (Sards  Modification  Card  1 

Ship  Cards  Modification  Card  2 

Ship  Cards  Modification  Card  3 

Ship  Cards  Modification  Card  4 

Initial  Supply 

Punch  Identification  Card 

Craft  and  Facilities  Card  1 

Craft  and  Facilities  Card  2 

Craft  and  Facilities  Card  3 

Craft  and  Facilities  Card  4 

(a'aft  and  Facilities  Card  S 

Craft  and  Facilities  Card  b 

Cr.ift  and  Facilities  Card  7 

Cratt  and  Facilities  Card  8 

Ship  Pool  Status 

Cargo  Dt'.  livery  Requirenent 

End  of  Record  Card 

I I I  -  ra  t  i  •  in 

J’r odui  t  1  V  !  t  y 

Distance  Table 

Cargo  ConvorsloTi  Factor 


COMPUTER  SYSTEM/RUN  INFORMATION 


The  TRADES  Model  Is  written  in  FORTRAN  IV  and  Is  designed  to  run  on  the 
CDC  6600  computer*  The  model  requires  135K  of  core  memory.  The  deck  setup  Is 
given  in  Figure  2;  Figure  3  lists  the  control  cards  necessary  to  make  a  computer 
run. 


Figure  2  -  Input  Deck  Setup 
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DESCRIPTION  OF  ROUTINES 

This  section  gives  a  brief  description  of  the  TRADES  routines*  Flowcharts 
and  program  listings  are  also  provided*  Appendix  A  defines  all  major  variables 
used  In  TRADES* 

ROACH 


Activity  Performed:  Initializes  input/output  files  and  begins  execution  of 

simulation 

Type:  Executive  routine 
Common  Used:  None 
Called  by:  n/a 
Stored  by:  n/a 

Subroutines  Called:  RDPARM,  TAKE 

Events  Stored:  None 

Files  used:  Tape  5,  Tape  6,  Tape  8 

Description 

ROACH  initializes  input/output  files  to  be  used  by  the  simulation.  Execution 
of  the  simulation  begins  by  calling  RDPARM  to  input  run  parameters  and  to  place 
initial  events  on  the  event  list*  ROACH  calls  TAKE  to  process  events  on  the  list* 


32 


m  ^  Ki 


J  3  »  S  O  S 

a  a  0.  a.  a  a 


a 

X  *o  « 

«  tf\  ft  H 

ft  44J 

o  ft  ^  ^  a.  o 

O  ft  ^  ^  o  z 

ft  »-  ft  <  ^  Ui 

ft  u  u  «o 


RDF  ARM  (HERAT) 

Activity  Performed:  Inputs  necessary  data  and  stores  Initial  events 
Type:  Subroutine 

Common  Used:  /CONTRL/,  /SUMY/,  /DONNA/,  /GEN/,  /CARGOG/,  /SHIP/,  /PORT/,  /WATE/, 
/B/,  /BUSHl/,  /BUSH2/,  /PET/ 

Called  by:  PRNTR,  ROACH 
Stored  by:  n/a 
Subroutine  Called:  RNG 

Events  Stored;  AVERAGE,  ENDGAM,  GENCAR,  PRNTR,  SHPARV,  SPOOL 
Files  used:  Tape  5,  Tape  6,  Tape  8 

Description: 

RDPARM  Inputs  all  data  necessary  to  run  the  simulation.  It  starts  the  time/ 
event  processing  by  initializing  control  counters  and  placing  events  to  be 
executed  on  the  event  list.  Entries  or  events  on  the  event  list  are  ordered  by 
occurrence  in  time. 

Since  TRADES  is  capable  of  simulating  many  cases  by  modifying  Initial  input 
data  in  the  same  computer  run,  a  second  entry  point,  ITERAT,  is  provided.  ITERAT 
is  called  from  PRNTR.  ITERAT  initializes  variables  changed  by  the  previous 
iteration,  stores  necessary  events,  and  executes  the  next  iteration  using  the 
modified  data. 
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999  FORM«T(  IHl.’T  IrE  ( DAYS  I  •,  5X,*P0RT*  ,9X,»SHI»»*  ,5X ,  RDPARN  393 

1»TRANSACT10N  DESCRIPTION*)  ROPARM  19A 

RETURN  ROPARM  395 

395  END  ROPARM  396 


AVRAGE 

Activity  Performed:  Keeps  track  of  the  numbers  of  transport  craft  and  cargo 

transfer  facilities  in  use. 

Type :  Event 

Common  Used:  /CONTRL/,  /A/,  /B/,  /GEN/,  /CARGOG/ , /SHIP/ ,  /PORT/,  /PLT/,  /WATE/ 

Called  by:  TAKE 

Stored  by:  RDPARM 

Subroutines  Called:  PUT,  MAXO 

Events  Stored;  AVRAGE 

Description: 

AVRAGE  stores  data  on  transport  craft  and  transfer  facilities  to  be  used 
later  by  PRNTR  in  calculating  the  average  numbers  in  use.  It  prints  current 
craft  and  facilities  usage  data  and  writes  these  data  on  a  disk  file.  AVRAGE 
keeps  track  of  the  total  number  of  times  the  upper  limits  (input)  on  the  number 
of  available  craft  and  facilities  are  reached. 
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DISTRI  (TYPE.  PARI,  PAR2 .  RESULT) 

Activity  Performed;  Computes  a  value,  RESULT,  derived  from  a  specified 

distribution  curve. 

Ty pe :  Subroutine 
Common  Used:  /GEN/ 

Called  by:  GENCAR 
Event  Stored:  none 

Description: 

DISTRI  uses  the  variance  information  given  by  DISTRI's  calling 
event  to  compute  a  value  derived  from  a  specified  distribution  curve. 

The  following  distributions  are  considered  by  DISTRI: 


Distribution  Type 

Parameter  1 

Parameter  2 

Random  Variable 

Constant 

Fixed  value 

Not  used 

Parameter  1 

Unifort 

Upper  limit 

Lower  limit 

Parameter  2  +  RN* 
(parameter  1  - 
parameter  2) 
where  RN  is  a  random 
number  between  zero 

one. 

Normal 

Mean 

Standard 

deviation 
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FORDER  (lARRAY.  NUM,  INDEX.  XRRAY.  IPTR) 

Activity  Performed;  Updates  an  array  by  eliminating  non-essential  entries 

Type:  Subroutine 

Common  Used :  none 

Called  by:  SPOOL 

Events  Stored:  none 

Description: 

FORDER  eliminates  all  unused  locations  of  a  given  array  amd  adjusts  the  Item 
entry  counter. 

GENCAR 

Activity  Performed:  Initializes  all  cargo  scheduled  to  enter  a  port  for  overseas 
delivery. 

Type;  Event 

Common  Used:  /CARGOG/,  /GEN/,  /SUMY/ 

Called  by:  TAKE 
Stored  by:  GENCAR,  RDPARM 
Subroutines  Called;  DISTRI,  PUT 
Events  Stored:  GENCAR 

Description: 

GENCAR  generates,  on  a  day-by-day  basis,  cargo  scheduled  to  enter  a  port  for 
overseas  delivery.  Input  specifies  cargo  type  to  be  generated,  origin,  destina¬ 
tion,  and  quantity  variance  Information.  Each  cargo  generation  specifies  a  time 
Interval  between  generations. 
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LDSH 

Activity  Performed:  Simulates  the  loading  of  cargo. 

Type:  Event 

Common  Used:  /CARGOG/,  /CONTRL/,  /GEN/,  /PORT/,  /SHIP/ 

Called  by:  TAKE 
Stored  by:  RLDSH 
Subroutines  Called:  PUT,  ENDGAM 
Events  Stored:  SHPLV 

Description: 

After  the  cargo  has  been  unloaded,  the  simulation  of  the  loading  cycle  begins. 
The  remaining  ports  on  the  ship's  schedule  are  determined  and  all  cargo  bouiiC  t  r 
those  ports  is  loaded  aboard  the  ship. 

LDSH  specifies  the  cargo  to  be  loaded  and  determines  the  time  of  loading,, 
using  available  transfer  systems.  After  loading  is  complete,  LDSH  stores  a  SHPLV 
event.  SHPLV  releases  facilities  no  longer  needed  and  repositions  the  ship  at  its 
next  service  port. 


COMPUTE  TIME 
TO  TRANSFER 
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NXPRTdDSHIP.  IDPORT.  NXPORT) 

Activity  Performed:  Determines  next  port  to  be  visited  by  non-ltlnerary  ship. 
Type:  Subroutine 

Called  by:  SHPARV.SHPLV 

Common  Used:  /GEN/,  /CARGOG/,  /SHIP/,  /PORT/ 

Stored  by:  n/a 
Subroutines  Called:  none 
Events  Stored:  none 

Description: 

NXPRT  determines  the  next  port  to  be  serviced  by  a  non-ltlnerary  ship.  Only 
ports  which  can  physically  receive  the  ship  are  considered.  Selection  Is  made 
with  respect  to  quantity  of  cargo  waiting  at  the  port,  quantity  of  cargo  aboard 
ship  to  be  delivered,  and  transit  time  between  ship's  present  port  and  destination 
port. 
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NXPRT 
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subroutine  NXPST(10SMIP,10POPT,NXPOPTj  nxprt 

COMHON  /COHTOtf  TIHI  T,  SHTFt  ,Of  CR<  41  ,  XO  1ST  f  3R,  SB  »  ,  PRODUCT  6,  6 , 8)  NXPRT 

1  .«CJCGO(8),NTEST  NXP  IT 

COMHON  NXPRT 
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PRNTR 


Activity  Performed:  Prints  the  output  generated  by  the  simulation* 

Type ;  Event 

Common  Used:  /CONTRL/,  /SUMY/,  /DONNA/,  /A/,  /B/,  /GEN/,  /CARGOG/,  /SHIP/, 

/PORT/,  /PIT/,  WATE/,  /BUSHl/,  /BUSH2/ 

Called  by:  TAKE 
Stored  by:  RDPARM 
Subroutines  Called:  n/a 
Events  Stored:  PRNTR 

Description: 

PRNTR  controls  the  printing  of  all  output  generated  by  the  simulation  except 
the  numbers  of  transport  craft  and  unloading  facilities  currently  In  use,  which  are 
printed  by  AVRAGE. 
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END 


PUT 


Activity  Performed:  Places  events  on  event  list  In  order  of  encounter. 

Type:  Subroutine 
Common  Used:  /GEN/ 

Called  by:  AVRAGE,  GENCAR,  LDSH,  PRNTR,  RDPARM,  RLDSH,  SHPARV,  SHPLV,  SPOOL, 
UNLDSH 

Subroutines  Called:  none 
Events  Stored:  none 

Description: 

PUT  enters  an  event  on  the  event  list,  KEVENT,  and  orders  the  list  according 
to  increasing  event  execution  times. 
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NEVENT  >500 
7 


WRITE 

"ERROR  EVENT 
LIST  OVERFLOW 


NO 


RLDSH 


Activity  Performed;  Simulates  the  unloading  of  cargo  at  commercial  ports. 

Type ;  Event 

Common  Used:  /CARGOG/,  /CONTRL/,  /GEN/,  /PORT/,  /SHIP/ 

Called  by:  TAKE 
Stored  by:  SHPARV 
Subroutines  Called:  ENDGAM,  PUT 
Events  Stored:  LDSH 

Description; 

RLDSH  simulates  cargo  unloading  at  a  commercial  port.  It  assigns  berth/ship 
transfer  systems  suitable  for  cargo  movement.  When  unloading  is  completed,  a  LDSH 
event  is  stored  to  perform  loading  operations. 


RLDSH 


UPDATE  TIME 
TIME  =  TIME  + 
UNLOADING  TIME 
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RNGl(RNG) 

Activity  Performed:  Computes  a  random  number  between  zero  and  one. 

Type:  Subroutine 
Common  Used:  /GEN/ 

Called  by:  DISTRI,  RDPARM 
Stored  by:  n/a 
Routines  Called:  none 
Events  Stored:  none 

Description: 

RNGl,  (RNG)  computes  a  random  number  between  0  and  1.  This  random  number 
is  used  to  compute  a  dependent  variable  from  a  specified  distribution  curve. 
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SHPARV 


Activity  Performed:  Assigns  an  incoming  ship  to  an  appropriate  berth. 

Type:  Event 

Common  Used:  /CARGOG/,  /CONTRL/,  /GEN/,  /PORT/,  /SHIP/,  /SUMY/ 

Called  by:  TAKE 

Stored  by:  RDPARM,  SHPLV,  SPOOL 

Subroutines  Called:  ENDGAM,  PUT 

Events  Stored:  RLDSH,  SHPLV,  UNLDSH 

Description: 

SHPARV  assigns  a  ship  to  a  berth  according  to  the  berth  types  preferred  by 
the  ship.  Only  berths  immediately  available  at  the  time  the  ship  enters  the  port 
are  considered.  If  no  appropriate  berth  is  available,  the  ship  enters  a  berth 
queue  until  a  preferred  berth  type  is  free.  All  berths  accept  ships  for  cargo 
transfer  on  a  first  come,  first-served  basis. 
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SHPLV 


Activity  Performed:  Releases  all  berth  facilities  used  by  a  departing 

ship. 

Type;  Event 

Common  Used;  /CARGOG/,  /CONTRL/,  /GEN/,  /PORT/,  /SHIP/,  /SUMY/ 

Called  by:  TAKE 
Stored  by:  LUSH,  UNLDSH 
Subroutines  Called:  NXPRT,  PUT,  UPDTE 
Events  Stored:  SHPARV 

Description: 

SHPLV  frees  all  berth  facilities  used  by  the  departing  ship  and  determines 
the  next  port  and  the  time  necessary  to  sail  to  the  next  port.  It  determines 
whether  any  other  ship  is  waiting  to  use  the  berth,  removes  the  next  waiting  ship 
in  the  berth  queue  from  the  queue,  and  stores  a  SHPARV  event  for  that  ship. 
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SPOOL 


Activity  Performed:  Reactivates  unused  ships  into  service. 

Type:  Event 

Common  Used:  /CARGOG/,  /CONTRL/,  /GEN/,  /PORT/,  /SHIP/,  /SUMY/ 

Called  by:  TAKE 

Stored  by:  RDPARM,  SHPARV,  SPOOL 
Subroutines  Called:  FORDER,  PUT 
Events  Stored:  SPOOL,  SHPARV 

Description: 

SPOOL  activates  the  ships  assigned  to  the  ship  pool  and  positions  them  at 
ports  having  excess  cargo.  After  all  ports  with  excess  cargo  have  been  deter¬ 
mined,  ships  which  satisfy  the  transfer  and  berthing  criteria  are  assigned 
to  service  ports  with  backlogged  cargo.  SPOOL  stores  a  SHPARV  event  for  each 
ship  scheduled  to  leave  the  ship  pool. 
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TAKE 

Activity  Performed;  Selects  the  next  event  to  be  executed  with  respect 

to  Che  current  simulation  time. 

Type:  Subroutine 

Common  Used:  /CONTRL/,  /GEN/ 

Called  by:  Main  program  ROACH 
Stored  by:  n/a 

Subroutines  Called;  All  events 
Events  Stored:  none 

Description: 

TAKE  removes  an  event  from  the  event  list  and  calls  It  Into  execution. 
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UNLDSH 


Activity  Performed:  Unloads  the  cargo  from  each  incoming  ship  at  an  over-the- 
beach  port. 

Type :  Event 

Common  Used:  /CONTRL/,  /A/,  /GEN/,  /CARGOG/,  /SHIP/,  /PORT/,  /WATE/,  /BUSHl/ 

Called  by:  TAKE 

Stored  by:  SHPARV 

Subroutines  Called:  PUT 

Events  Stored:  SHPLV 

Description: 

UNLDSH  controls  the  unloading  of  ship  cargo  at  the  over-the-beach  destination 
port.  It  checks  on  the  availability  of  transport  craft  and  unloading  facilities. 
If  facilities  are  available,  the  ship  is  unloaded.  Otherwise,  the  ship  is  put 
into  a  queue  until  such  time  as  craft  and  unloading  facilities  are  available. 

UNLDSH  also  updates  the  numbers  of  transport  craft  and  unloading  facilities 
currently  in  use  by  subtracting  the  number  needed  to  unload  the  newly  arrived 
ship  from  the  number  previously  available. 


COMPUTE  TOTAL  AMOUNT 
OF  CARGO  ON  SHIP  IN 
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UPDTE 


Activity  Performed:  Keeps  track  of  amount  of  cargo  unloaded  and  updates  numbers 

of  craft  and  facilities  currently  In  use. 

Type:  Subroutine 

Common  Used:  /CONTRL/,  /A/,  /SUMY/,  /GEN/,  /CARGOG/,  /SHIP/,  /PORT/,  /WATE/ 

Called  by:  SHPLV 

Stored  by;  n/a 

Subroutines  Called:  n/a 

Events  Stored:  n/a 

Description: 

UPDTE  updates  the  numbers  of  transport  craft  and  unloading  facilities 
currently  In  use  by  adding  the  number  needed  to  unload  the  departing  ship  to  the 
number  previously  available. 

UPDTE  also  tabulates,  In  measurement  tons,  cargo  unloaded  by  all  ships,  both 
by  types  of  cargo  and  by  total  amount. 
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APPENDIX 

LIST  OF  COMMON  VARIABLES 


VARIABLE 

COMMON 

MODE 

■  I  - 

Input 

-  S  - 

Storage 

m  It  ^ 

Packed 

AA 

PLT 

S 

ADJCG0(8) 

CONTRL 

1 

ATTCS(4) 

BUSHl 

s 

CARGC(2) 

CARGOG 

I 

CARGEN(IOOO) 

CARGOG 

I 

CARGO (1000) 

CARGOG 

S 

DECR(4) 

CONTRL 

I 

DOFFSH 

A 

I 

DTME(3) 

BUSHl 

I 

IAVAL(50) 

SUMY 

s 

lAVRGE 

B 

s 

ICFT(4) 

CONTRL 

s 

IDSCGO(40,2) 

A 

s 

IFAC(30,10) 

PORT 

I 

IGEN 

GEN 

I 

lOUT 

GEN 

I 

IPLT 

PLT 

s 

IQUEUEdOOO, 

2)  PORT 

s* 

1SD(50,3) 

SUMY 

s 

ISMPRT(30,6) 

SUMY 

s 

DESCRIPTION 


Craft/facilitles  current  status 
check  Indicator 

Cargo  type  conversion  factor  (MT/LT) 

Average  number  of  times  each  type  of 
craft  comes  to  shore 

Cargo  necessary  for  selection  of 
next  port  (MT) 

Cargo  generation  information 

Cargo  in  transit  accumulators 

Number  of  landing  craft  to  be 
decremented 

Distance  offshore  at  which  offloading 
of  ships  occurs 

Delay  time  to  be  added  to  cycle  time 
for  each  transfer  craft 

Total  ship  volume  available  (MT) 

Internal  counter  fi:  number  of  times 
subroutine  AVRAGE  has  been  called 
since  last  status  summary  printout 

Number  of  each  type  of  landing  craft 

Cargo  to  be  unloaded  from  ships 

Number  of  each  type  of  facility  at 
each  port 

Cargo  generation  deck  indicator 

Output  option  indicator 

Number  of  times  craft  and  facilities 
usage  data  are  output  on  TAPE30 

Berth  facility  queue  information 

Cargo  movement  summary  table 

Port  facilities  delay  times 
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APPENDIX  (Con't) 


VARIABLE 

COMMON 

MODE 

DESCRIPTION 

ISUFAC(2,2) 

WATE 

S 

Number  of  shoreside  unloading 
facilities  of  type  I  currently  for 
ISUFAC(1,2) 

ITCFT(4,2) 

WATE 

S 

Number  of  transfer  craft  currently 
in  use 

ITIN(10,10) 

SHIP 

I 

Ship  itineraries 

IUP(2) 

WATE 

S 

Number  of  unloading  platforms  cur¬ 
rently  in  use 

IUPCFT(4) 

WATE 

S 

Number  of  times  maximum  number  of 
transfer  craft  is  reached 

IUPSUF(2) 

WATE 

s 

Number  of  times  maximum  shoreside 
unloading  facilities  used 

lUPUP 

WATE 

s 

Number  of  times  upper  limit  of 
maximum  unloading  platforms  used 

JCARGO(1000,3) 

CARGOG 

s* 

Cargo  aboard  ship  information 

KARGEN(1000,3) 

CARGOG 

I* 

Cargo  generation  Information 

REVEST (5 00) 

GEN 

s* 

Event  list 

KPNCH 

BUSH2 

I 

Option  for  punching  build  up  ashore 
statistics 

KQUEUE(50) 

A 

s 

Table  of  ships  waiting  to  be  unloaded 

KSUFAC(2) 

WATE 

s 

Total  number  of  shoreside  unloading 
facilities 

KTCFT(4) 

WATE 

s 

Total  number  of  transfer  craft 

KUP 

WATE 

s 

Total  number  of  unloading  platforms 

KY(110,7) 

PLT 

s 

Number  of  transfer  craft  and  unloading 
facilities  currently  in  use 

LDCRF(4) 

CONTRL 

s 

Current  number  of  landing  craft 
(by  type) 

EVENT 1 

GEN 

s 

Event  list  parameter 

LVENT2 

GEN 

s 

Event  list  parameter 

L VENT 3 

GEN 

s 

Event  list  parameter 

MQUE(5) 

A 

s 

Number  of  ships  currently  in  unloading 
queue 

MTEST 

CONRL 

s 

Optimum  iteration  check 

MTSHIP(30,22) 

SHIP 

I 

Ship  type  information 

MTSHP2(30,10) 

SHIP 

I 

Ship  type  information 

NCARGN 

CARGOG 

I 

Number  of  cargo  generations 

APPENDIX  (Con't) 


VARIABLE 

COMMON 

MODE 

DESCRIPTION 

NEVENT 

GEN 

S 

Number  of  event  list  entries 

NFACT 

GEN 

I 

Number  of  berthing  facility  types 

NITIN 

GEN 

I 

Number  of  ship  Itineraries 

NMFT(5) 

BUSH2 

I 

Names  of  transfer  craft  1-5 

NNPORT 

GEN 

I 

Number  of  ports 

NPORT(30,6) 

PORT 

I* 

Port  Information 

NQUEUE 

PORT 

S 

Number  of  entries  on  facility  queue 
list 

NSC  GO 

CARGOG 

s 

Number  of  entries  of  cargo  aboard  ship 

NSD 

SUMY 

s 

Day  of  summary  Information 

NSE(30,30) 

PORT 

s 

Number  of  ships  of  each  type 
scheduled  to  enter  port 

NSHIP(400,15) 

SHIP 

I 

individual  ship  Information 

NSHIPS 

GEN 

I 

Number  of  ships  In  simulation 

NSTYP 

GEN 

I 

Number  of  ship  types 

NSUFAC 

WATE 

I 

Number  of  available  shoreside  unload¬ 
ing  facilities 

NTCFT 

WATE 

I 

Number  of  available  transfer  craft 

NTEST 

CONTRL 

s 

Number  of  Iterations 

PERCKSO) 

SUMY 

I 

Fractional  portion  of  ship's  total 
volume  to  be  used  for  cargo 

PRODUC(6,6,8) 

CONTRL 

I 

Productivity  rates  (MT/day) 

PUTL 

GEN 

I 

Minimum  percentage  of  ship  volume  In 
use  before  ship  Is  allowed  leave  port 

RN 

GEN 

s 

Random  number 

SHTFL 

CONTRL 

s 

Last  computed  shortfall 

SHTFLM 

CONTRL 

I 

Maximum  shortfall  allowed 

SUMPRT(30,10) 

SUMY 

s 

Port  Information  summary  table 

SIIMSHP(30,10) 

SUMY 

s 

Ship  Information  summary  table 

TCARGO 

A 

s 

Total  amount  of  cargo  unloaded 

TEVENT 

GEN 

s 

Time  of  event 

TIME 

GEN 

s 

Simulation  time 

TIMIT 

CONTRL 

I 

Time  check  for  (SHTFLM)  shortfall 

TIMSAV 

CONTRL 

s 

Time  Interval  between  summary  outputs 

121 


tm 


m 


VARIABLE 

COMMON 

MODE 

TINVL 

GEN 

I 

TNKRTE 

WATE 

I 

TTCS(4) 

BUSHl 

S 

TUNLTC(A) 

BUSHl 

S 

UNLTC(4) 

BUSHl 

S 

UTM(50) 

SUMY 

S 

XAX(IIO) 

PLT 

s 

XCARGO(O) 

A 

I 

XDIST(30,30) 

CONTRL 

I 

XQUEUE(50) 

A 

S 

XSUFAC(2) 

WATE 

I 

XTCFT(4,2) 

WATE 

I 

XUP 

WATE 

I 

YCARGO(40,9) 

A 

S 

ZCARG0(9) 

A 

s 

APPENDIX  (Con't) 

DESCRIPTION 

Summary  time  Interval 

Tanker  unloading  rate  (barrels/day) 

Total  number  of  times  each  type  of 
transfer  craft  comes  ashore 

Total  (aggregate)  unloading  time 
for  all  craft  of  a  given  type 

Unloading  time  for  one  craft  of  a 
given  type 

Ship  utilization  summary  table 

Time  of  craft  and  facilities  usage 
summary 

Amount  of  each  type  of  cargo  on  ship 
(MT's) 

Table  of  Distance  between  ports 
(nautical  miles) 

Time  ship  enters  unloading  queue 

Unloading  rate  for  shoreslde  unload¬ 
ing  facility  units 

Speed  of  transfer  craft  (knots) 

Unloading  rate  of  unloading  platform 
(MT/day) 

Cargo  unloaded  from  ships  In  queue 

Amount  of  each  type  of  cargo  unloaded 
from  a  given  ship  (MT/day) . 
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